home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / raytrace / dkb / dkbutdoc.zoo / twister.doc < prev    next >
Encoding:
Text File  |  1991-06-09  |  3.3 KB  |  93 lines
  1. TWISTER V1.00 
  2. _____________________________
  3.  
  4.  
  5. Files include in TWIST.ZIP -
  6.  
  7.     TWISTER.COM  - The compiled 'twister' generator.
  8.     TWISTER.DOC  - Instructions for use of TWISTER.
  9.     TWISTED.DAT  - Sample DKB dat file to display 'twister'
  10.     TWISTED.GIF  - 320 X 200 picture of TWISTED.DAT.
  11.     TWISTER.C    - Source code for TWISTER.COM.
  12.  
  13.  
  14.         [ TWISTER.COM ]
  15.  
  16.   The program TWISTER.COM will create a data file for the DKB raytracer 
  17. describing an object that looks something like a twisted ribbon or a piece 
  18. of macaroni. I used this program to create the floating macavirus in 
  19. "Not a Trace of Reality" a.k.a Ntreal.gif. The 'twister' is a DKB UNION made 
  20. up a many instances of a DECLAREd quadric. TWISTER.COM generates the 
  21. complete code and a usable quadric, all the user needs to do is generate the 
  22. 'twister' dat file, INCLUDE it in a DKB scene file and place the 'twister' 
  23. in their scene. TWISTED.DAT is an example of how to use the file generated 
  24. by TWISTER.COM.
  25.  
  26.           [*INCLUDE WARNING!*]
  27.   DKB Ver 2.04 and earlier can only correctly use one INCLUDE file. Because 
  28. of the high number of objects needed to create a twister the code is best kept
  29. in an INCLUDE file, but if you are using ver 2.04 or earlier you will need to
  30. merge the twister file into your DKB dat file.
  31.  
  32.  
  33.  
  34. Parameters: [Default Values]
  35.  
  36.   File name: [twist.dat]
  37.     This is the name of the file generated by TWISTER.COM
  38.  
  39.   Union Name: [Macaroni]
  40.     Name of the 'twister' UNION to use in DECLARE statement.
  41.  
  42.   Quadric Name: [Part]
  43.     Name of the DECLAREd quadric from which to build twister UNION.
  44.     TWISTER.COM creates a sample quadric from the name you supply, but 
  45.     any quadric may be used for the twister, just comment out the
  46.     sample quadric and supply your own.
  47.  
  48.   Length of twister : [20.0]
  49.     Version 1.00 of TWISTER.COM creates the object from the ground up.
  50.     The quadrics in twister UNION will start at Y = 0.0 and end at
  51.     Y = Length. The width is determined by the size of the quadric.
  52.  
  53.   Number of pieces : [50]
  54.     The number of quadrics to use in building the twister.
  55.     Low values make the twister blockier.
  56.     Higher values will create a smoother shape.
  57.  
  58.   Number of twists : [1.0]
  59.     How many complete twists the twister makes.
  60.     Values below 1.0 create a more gentle curve.
  61.     Higher values make the twister more corkscrew-ish.
  62.  
  63.  
  64.         [ TWISTED.DAT ]  
  65.  
  66.   TWISTED.DAT is a simple DKB data file that demonstrates the use of the 
  67. file TWIST.DAT. TWIST.DAT is generated by running TWISTER.COM with the default
  68. values. On a IBM PC 386/20 & 387 coprocessor TWISTED.DAT renders in about
  69. 3 minutes at 80 X 60 with no anti-aliasing and about 2 hours at 320 X 240 
  70. with default anti-aliasing.
  71.  
  72.  
  73.         [ TWISTER.C ]
  74.  
  75.   TWISTER.C is the C language source code to TWISTER.COM. It should compile 
  76. with any ANSI C compiler and I've tried to make it easily modifiable to create
  77. more complex shapes. You are free to modify the code and distribute, but not to
  78. extract payment for this code. Please comment your changes, use the update 
  79. list in the source header comment and include this doc file. 
  80.  
  81. * This copyrighted code is released for non-commercial use only. *
  82. * It may not be sold or used as part of a commercial package.    *
  83.  
  84.  
  85.   Experiment and enjoy!
  86.  
  87.     Drew Wells [CIS 73767,1244]
  88.     P.O. Box 952
  89.     Los Alamitos, CA
  90.     90720
  91.  
  92.     December 1990 
  93.